GXLockColorProfile
You can use the GXLockColorProfile function to load a color profile object into memory and lock its profile data into a fixed memory location.
void GXLockColorProfile (gxColorProfile source);
source
- A reference to the color profile to be loaded and locked.
DESCRIPTION
The GXLockColorProfile function prevents a color profile from being relocated, so that you can manipulate its profile data directly in QuickDraw GX memory rather than working with a copy of it in application memory.To directly edit the color profile, call GXLockColorProfile followed by GXGetColorProfileStructure; after editing, call GXUnlockColorProfile.
SPECIAL CONSIDERATIONS
To avoid fragmenting the QuickDraw GX heap, call the GXUnlockColorProfile function as soon as possible after calling GXLockColorProfile.In low memory situations with a fragmented heap, QuickDraw GX can unlock locked objects without warning. Be careful about making memory-intensive calls when you are working with a locked color profile.
ERRORS, WARNINGS, AND NOTICES
Errors out_of_memory colorProfile_is_nil SEE ALSO
The GXUnlockColorProfile and GXGetColorProfileStructure functions are described in the next two sections.
Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help